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CROSS-REFERENCE TO RELATED APPLICATIONS 

The present application is a continuation of commonly assigned copending U.S. 
Patent Application Serial No. 09/451,216, which was filed on November 29, 1999, by 
Reine et al. for an Application Programming Interface for Modem and ISDN Processing, 
which was a continuation of U.S. Patent Application Serial No. 08/893,192, which was 
filed on July 15, 1997, by Reine et al. for an Application Programming Interface for Mo- 
dem and ISDN Processing, has now issued as U.S. Patent No. 6,023,473, and claimed the 
benefit of U.S. Provisional Patent AppUcation Serial No. 60/022,812, filed July 25, 1996, 
tiie disclosure of which is incorporated herein in its entirety by reference. 

BACKGROUND OF THE INVENTION 

Communication among computers is typically implemented over telephone lines. 
In analog or "voice" communication, a modem provides the interface between the tele- 
phone line and a host computer to convert telephone line signals to computer signals and 
computer signals to telephone signals. Modem telephone communications are also im- 
plemented in digital format. In one digital configuration, analog or voice originated data 
is digitized and transmitted in digital format over the telephone line. A digital modem 
can receive the digitized data and covert it to computer readable data. Alternatively, 
digital data transmitted over telephone lines in ISDN format is received by an ISDN ter- 
minal adapter which provides the interface between the digital telephone line and the host 
computer. 

In any of these configurations, an interface must be provided between the host 
computer and the telephone processing equipment, i.e., the modem or terminal adapter. 
The interface, in both hardware and software, provides for command and data communi- 
cation between the user and the modem or terminal adapter. The interface also allows an 
application or driver running on the host computer to interface with the modem or termi- 
nal adapter. The interface, commonly referred to an "application programming interface" 
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or "API," transmits and receives commands and data to and from the modem or terminal 
adapter to implement computer/telephony communication. 

Typically, the software application programming interface (API) runs on the host 
computer. It defines and maintains command and data structures required for communi- 

5 cation between the host driver and the modem or terminal adapter. A conventional API is 
specific to the communication mode implemented on the applicable telephone line. That 
is, where ISDN communication is being provided, the API running on the host computer 
is specific to an ISDN terminal adapter. Where analog or voice is used, the API is spe- 
cific to modem operation. Thus, traditionally, the host computer is interfaced to a single 

10 form of telephone line communication and runs an API applicable to only that single 
conmiunication mode. If multiple communication modes are to be used, in a traditional 
configuration, the host computer must run an API for each mode. 

SUMMARY OF THE INVENTION 

The present invention is directed to a host processor for providing an application 

15 programming interface. The API of the invention provides an interface between a host 
application, driver or user and telephone processing-equipment tiiat is capable of proc- 
essing ISDN telephone calls and analog or voice-originated calls. The API of the inven- 
tion includes a host interface which transfers signals between the host computer driver or 
user and the telephone processing system. The API also includes a modem interface 

20 which transfers signals to and from the host interface and which transfers commands and 
data associated with analog or voice-originated telephone calls between the host interface 
and a modem processor within the telephone data processing system, the modem proces- 
sor processing data associated with analog or voice-originated telephone calls. The API 
of the invention also includes an ISDN interface which transfers signals to and from the 

25 host interface and which transfers commands and data associated with ISDN telephone 
calls between the host interface and an ISDN processor in the telephone data processing 
system, the ISDN processor processing data associated with ISDN telephone calls. 

The API of the invention can be used with a telephone processing system that is 
capable of processing data for both ISDN and analog-originated telephone calls. It can 

30 also process data for multiple simultaneous telephone calls of either type or of both types. 
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Such a telephone data processing system is described in co-pending U.S. Patent AppUca- 
tion Serial No. 08/686,990, filed July 25, 1996, entitled "Apparatus and Method For 
Processing Multiple Telephone Calls," assigned to the same assignee as the present ap- 
plication. The contents of that co-pending application are incorporated herein in their 

5 entirety by reference. 

Despite the ability of the API of the invention to facilitate plural telephone call 
types, the specific type of call being processed is transparent to the user or driver. That 
is, the user can implement interface processing without knowing the type of call being 
processed. To this end, in the API of the invention, the host API is at the user level and 

10 accepts commands and data from the user. The API of the invention also includes two 
lower-level APIs, namely, a modem API and an ISDN API, which are implemented 
based upon the type of call being processed. 

The modem API is implemented when voice or analog originated calls are proc- 
essed. In this case, the host API processes and formats commands and data from the host 

15 or driver for modem processing. The modem API receives the modem commands and 
data from the host API and generates modem commands and data and forwards them to 
the modem processor in the telephone data processing system. 

The ISDN API is implemented when ISDN calls are processed. For ISDN calls, 
the host API processes and formats commands and data entered by the host for ISDN 

20 processing. The command and data are received from the host API. In response, the 
ISDN API generates ISDN commands and data and forwards them to an ISDN processor 
in tiae telephone data processing system for ISDN processing. 

The API of the invention provides numerous advantages over interfaces provided 
in conventional computer/telephone interface systems. The API of the invention provides 

25 the user with the flexibility of processing different types of telephone calls while not re- 
quiring the user to know which type of call is being processed. In other conventional 
systems, the API is specifically dedicated to a particular type of telephone call and, there- 
fore, can only provide the user access to that type of call. The API of the invention pro- 
vides the user with the ability to process different types of telephone calls, while main- 

30 taining transparency to the user, such that the user need not know the type of call being 
processed. 
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The API of the invention allows the user to process multiple telephone calls si- 
multaneously, such calls being received in multiple channels of a basic rate ISDN (BRI) 
or a primary rate ISDN (PRI) telephone line. The ability to process multiple simultane- 
ous telephone calls of multiple call types makes the API of the invention applicable to 
systems which regularly process multiple telephone calls simultaneously. Such systems 
could include Intemet service providers. In conventional systems, both the hardware and 
the associated software interface had to be provided for each individual line. The system 
of the invention is therefore far less hardware and software intensive and, therefore, more 
efficient and less costly than conventional systems. 

BRIEF DESCRIPTION OF THE DRAWINGS 

The foregoing and other objects, features and advantages of the invention will be 
apparent from the following more particular description of preferred embodiments of the 
invention, as illustrated in the accompanying drawings in which like reference characters 
refer to the same parts throughout the different views. The drawings are not necessarily 
to scale, emphasis instead being placed upon illustrating the principles of the invention. 

FIG. 1 is a schematic fimctional block diagram which illustrates the application 
programming interface of the invention. 

FIG. 2 is a schematic hardware block diagram which illustrates the application 
progranraiing interface of the invention. 

DETAILED DESCRIPTION OF AN ILLUSTRATIVE 

EMBODIMENT 

FIG. 1 is a schematic functional block diagram that shows one embodiment of the 
application programming interface 1 10 of the invention. As shown in the figure, the 
API 1 10 of the invention is resident on a host computer 12. The API 110 interfaces with 
a driver or application or a user 14 which transmits commands and data to the API 1 10 to 
control the communication between the host computer 12 and telephone line 16. 

In this embodiment, the API 110 includes a user-level host API 18, a lower-level 
modem API 20 and a lower-level ISDN API 22. The driver 14 interfaces with flie 
API 1 10 via the host API 1 8. Depending upon the type of telephone call being processed, 
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the host API 1 8 in turn interfaces with either the modem API 20 and/or the ISDN API 22. 
The commands issued by the driver 14 are independent of the type of telephone call The 
API 18 identifies the call type and formats and forwards the appropriate commands and 
data to the modem API 20 and/or ISDN API 22. The driver need not be aware of the type 
of telephone call being processed and, therefore, need not select commands and data 
based on call type. That distinction is made by the host API 18. 

In the embodiment depicted in FIG. 1, the API 1 10 of the invention interfaces 
with a telephone data processing system 24. The processing system 24 is capable of per- 
forming both modem processing 26 on analog or voice originated calls as well as ISDN 
processing 28 on ISDN type telephone calls. The telephone data processing system 24 
can be of the type described as the MICA™ unit in the copending U.S. Patent Applica- 
tion Serial No. 08/686,990, entitled "Apparatus and Method for Processing Multiple 
Telephone Calls," incorporated herein by reference. 

The MICA™ imit described in that co-pending application includes a PRI inter- 
face board for performing ISDN processing 28 as well as a multiple-modem and port 
processor board used for modem processing 26. The multiple modem board, in one em- 
bodiment, includes five "hex modxiles," each of which is capable of processing six mo- 
dem telephone calls simultaneously. Hence, the multiple-modem board can process up to 
thirty simultaneous telephone calls. 

The telephone data processing system 24 also includes a telephone interface 30 
which is connected to the telephone line 16. Data from modem processing 26 and/or 
ISDN processing 28 are formatted by the telephone interface 30 for transmission over the 
telephone line 16. When receiving from the telephone line, the telephone interface 30 
receives incoming telephone data and formats it according to the telephone call type and 
forwards it to the appropriate processing 26 or 28. 

FIG. 2 is a schematic hardware block diagrmi which shows one embodiment of 
the API 110 (Fig. 1) of the invention. As described above in connection with FIG. 1, the 
API 110 is implemented on the host computer 12. The computer 12 can be any computer 
that includes a processor 32 coupled to a memory 34. In normal fashion, the processor 32 
accesses data and instructions stored in memory 34 to execute the interface function of 
the present invention. The computer 12 can also include the user, interface 36 for pro- 
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viding input/output from/to the user, application or driver to control communication be- 
tween the host computer 12 and telephone line 16. The computer 12 also includes an in- 
terface 38 which provides for conmiunication between the host computer 12 and the tele- 
phone data processing system 24. The host interface 40 in the processing system 24 also 
facilitates that communication. 

As described above, the telephone data processing 24 is capable of processing 
analog or voice-originated calls via modem processor 42 as well as ISDN calls via ISDN 
processor 44. A telephone interface 46 provides the hardware and software interface 
between the telephone line 16 and the modem 42 and ISDN 44 processors. As described 
above, the telephone data processing system 24 can be of the form of the MICA unit de- 
scribed in U.S. co-pendmg Patent 5 Application Serial No. 08/686,990. 

As described in that co-pending application, MICA is an acronym for Mo- 
dem-ISDN Channel Aggregation and is used to identify the capability of the system to 
process both modem and ISDN data. The system includes a card set which includes a 
commercially available PRI interface card (ISDN processor 44) and a proprietary multi- 
ple-modem processing card (modem processor 42). The MICA card set is typically pro- 
duced for use in ISA bus personal computers. The PC host software is responsible for 
command and data flow between the host-based driver and the MICA card set. The host 
software provides the interface 1 10 of the present invention. 

The API 110 of the invention provides the software interface between the host 
computer operating system drivers and the modem 42 and ISDN 44 processors which, in 
one embodiment, are the MICA board set. This is done by providing an application pro- 
gramming library of fimction calls independent of operating system which provide com- 
mand and data teansfer and status reporting capabilities to the host application. As shown 
in FIG. 1 , the host API 1 8 interfaces to both the modem API 20 and the ISDN API 22 and 
presents a single interface to the user. This layering enables the API 1 10 of the invention 
to present a consistent interface to a device driver even if the underlying board(s) should 
change. 

The MICA board set is accessed via a shared memory interface. This interface 
allows the host software to address the boards' memory as though it was addressing host 
memory. The board memory is accessed through a window of a fixed size in a host 
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memory space. While the host window does not move, the base address of the window 
can. This is accomplished by changing the addresses in the boards' page register. Each 
page of the boards' memory is the size of the host's memory window. In this way, the 
MICA boards' entire memory range can be accessed while using a small portion of the 
host memory space. 

The host API 18 includes of a number of operating system-independent function 
calls to be made by an operating-system-specific driver. The OS driver uses this API 18 
to manipulate the modem processor 42 and the ISDN processor 44, which, in one em- 
bodiment, comprise the MICA board set The host API library provides an interface be- 
tween the device driver 14 and lower-level board specific function calls in the modem 



API 20 and ISDN API 22. Table 1 contains a Ust of these host API function calls. 







CFarpose 


Initialization 


MICA_Accept() 


Accept an incoming call. 




MICA_Close ( ) 


Close a data channel; used 
for terminating a call 




MICA-Connect ( ) 


. Dial the phone 




MICA_Init() 


Initialize the boards; 
should be called once per 
board. 




MICA^Listen ( ) 


Listen on a channel for an 
incoming call. 




MICA_Open() 


Open a channel for lis- 
tening or dialing. 




MICA_Reset() 


Reset a board; used when 
a board needs to be re- 
started. 


Data Flow 


MICA_Recv() 


Receives data (if any) 
from a previously opened 
channel. 




MICA_Select ( ) 


Check a chaimel's status. 




MICA_Send() 


The channel must be 
opened first; sends data 
out to the MICA board 
set. 
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Control Messages 


MICA_GetOption() 


Get the status of a system 






option. 




MICA_ProcessInt() 


Process a MICA interrupt. 




MICA_SetOption ( ) 


Set or modify a system 






option. 



Table 1. Host API Function Call Summary 



All of the host API function calls send parameters with each function call. Each 
function also returns a result code to indicate the result of the function call. Each func- 
tion call will now be described in detail. 

The MICA_Accept call is used to accept an incoming call on a particular channel. 
A sample format for the call is as follows: 
MICA_Accept ( 

intl6 channelld 
) 

The parameter channelld indicates the ID number of the channel on which the call is to 
be accepted. The possible result codes are as follows: 

MICA_SUCCESS The call is accepted. 

MICA^ERROR The call is rejected. 

The MICA_Close function call is used to close a data channel. A sample format 
is as follows: 

MICA_Close ( 

intl6 channelld 
) 

The parameter channeUd is used to identify the channel that is to be closed. The possible 
result codes are as follows: 
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MICA_SUCCESS The channel is closed. 

MICA_INVALID_CHANNEL The channel provided was not valid. 

MICA_NOT_OPEN The channel was not open. 

MICA^ERROR Either the ISDN or the modem board 

didn't close. 

The MICA Connect function call is used to open a data channel to initiate an out- 
going telephone call. A sample format for the call as follows: 
MICA_Connect ( 



intl6 channel Id, 

char *phoneNumber, 

void (*calIBack)(channelId, event_mask) 

) 



If the optional callBack routine is provided, it is executed after the connection is 
made. The chaimelld is returned with the callBack routine allovdng a use of a single 
callBack routine with many channels. The eventmask reflects the state of the channel 
after the connection is made. The parameter channelld identifies the channel to be dialed. 
If the callBack routine is used, the channelld is provided. The parameter phoneNumber 
is a pointer to the phone number to be dialed. The number is in ASCII text format. The 
callBack parameter identifies the callback routine, and the parameter event_mask identi- 
fies the status of the channel after the connection is completed. It should be noted that 
prior to calling the MICA Connect fimction, the application must call MICA_Open. The 
possible result codes retumed after the MICA Connect call are as follows: 



MICA_ 


CHANNEL_NOT_OPEN 


The channel was not opened. 


MICA_ 


CONNECT_NO_CHANNELS 


There are no available channels. 


MICA_ 


_ERROR 


General Error message. 


MICA_ 


.INVALID_CALL_TYPE 


The call type was invalid. 


MICA_ 


SUCCESS 


Connecting. 


MCA. 


_INVALID_CHANNEL 


The channeUd provided was invalid. 
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The MICA GetOption function call is used to get status and other information 
from the board set. A sample format for the MICA_GetOption call is as follows: 
MICA_GetOption( 



intl6 channelld, 

intl6 *micaCommand, 

char *retumData 
) 



The requested data is written into the retumData buffer. Note that this buffer should be 
large enough to hold the maximum size return message. The parameter board_set identi- 
fies the MICA board set on which the operation is to be performed. The micaCommand 
parameter identifies the conmiand, and the retumData parameter indicates the returned 
data value. The possible result codes are as follows: 

MICA_INVALID_COMMAND The specified command was not recog- 

nized. 

MICA_SUCCESS The command completed successfully. 

MICA ERROR The command failed to complete. 

The MICA_Init function call is used to initialize the telephone data processing 
system 24. For one embodiment, a sample format for the call is as follows: 
MICAJnit( 

mica_status_str *micaSto, 
char *buffer, 
intl6 buffer_len, 
intl6 channels, 
intl6 channellds 

) 

The micaStr parameter identifies the MICA status structure. The buffer parameter identi- 
fies memory allocated for MICA structures. The bufferjen parameter identifies the size 
of the buffer in bytes. The channels parameters identifies the number physical channels, 
and the channellds parameter identifies the number of virtual channels. The possible re- 
sult codes are as follows: 
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MICA_INIT JNSUFFICIENT_DATA Not enough information was pro- 
vided. 

MICA^INIT^INSUFFICIENT^BUFFER The buffer provided was too small. 

MICA_ERROR The command failed to complete. 

MICA_SUCCESS The command completed success- 

fully. 

Note: the calling application is responsible for allocating sufficient space for the MICA 
Status structure (for example malloc (size of (mica_status_str))). The MICA API assumes 
sufficient space has been allocated. 

The MICA_Listen function call is used to open a data channel to receive an in- 
coming call. An example of its format is as follows: 
MICA^Listen ( 

intl6 channelld, 

char *phoneNumber, 

void (*callBack)(channelId, event mask) 

) 

The channelld parameter indicates the assigned channel. When used in the callBack rou- 
tine, the channelld represents the chaimel on which the called was received. The phone- 
Number p^ameter indicates the number to listen for; the callBack parameter indicates the 
routine that is to be executed when the call arrives and the parameter event_mask indi- 
cates the state of the chaimel after the call is accepted. Possible result codes are as fol- 
lows: 

MICA_SUCCESS The channel was opened successfiiUy. 

MICA_CHAN_INVALID The channel parameter was invalid. 

The MICA_Open fimction call is used to open a data channel. A sample format for 
the call is as follows: 
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MICA_Open ( 



intl6 callType, 

intl6 direction, 

intl6 assignResource, 

intl6 *error 
) 



The callType parameter indicates the type of call being requested, i.e., ISDN or modem. 
The direction parameter indicates whether the call is an inbound or outbound call. The 
assignResource parameter allocates the modem or ISDN channel to the identified MICA 
channel. This parameter is typically assigned a Boolean true/false variable. The error 
parameter is a pointer to a variable for error reporting. This avoids confusion between a 
valid channel ID and an error value. The optional callType and direction parameters are 
of particular use when some channels are restricted to outbound or inbound calls only. 
The assignResource parameter is useful when over-subscription of the channels is al- 
lowed. If the call is successful, a channelld is returned. If an error occurred, 
MICA_ERROR is returned. The error type is identified in the error byte. The possible 
values for error are: 

MICA_OPEN_INVALID_TYPE The callType is invalid. 

MICA_OPEN__INVALID__DIRECTION The direction was invalid. 

MICA_OPEN^NO_CHANNELS No idle channels. 

The MICA_ProcessInt function call is used to process an interrupt. Once an inter- 
rupt service routine or polling routine has detected that a board needs service, this routine 
is used to service the board. A format for the call is as follows: 
MICA_ProcessInt( 

intl6 intType, 
intl6 callType 

) 

The intType parameter indicates the type of interrupt received, i.e., data or con- 
trol. The callType parameter indicates the call type, i.e., ISDN or modem. The possible 
result codes are as follows: 
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MICA^SUCCESS The board(s) were successfully 

serviced. 

MICA_ERROR An error occurred while servicing 

the boards(s). 

The MICA_Recv function call is used to hand a data buffer to receive data for a 
specific channel. A format for the call is as follows: 
MICA_Recv ( 



intl6 channelld, 

char *dataBuffer, 

intl6 bufferSize 

) 



The channelld parameter indicates the channel from which data is received. The 
dataBuffer parameter indicates the buffer in which the data is placed, and the bufferSize 
parameter indicates the number of bytes that can be written into the buffer. The buffer- 
Size parMieter is normally the maximum number of bytes that can be inserted into the 
data buffer. The return result is typically the number of bytes actually written into the 
data buffer. If an error occurred while data is being copied into the buffer, an error bit, 
typically -1, is returned. The MICA_Reset function call is used to reset the MICA board 
set(s). A format for the call is as follows: 
MICA_Reset( 

intl6 boardJ;o__reset 
) 

The parameter board_to_reset indicates which board is to be reset, since more than one 
MICA board set can be used in the system. After this function is called, the MICA board 
set must be reinitialized by calling MICA_Init before any other calls can be made. The 
typical result codes returned after a MICA Reset call are as follows: 

MICA_SUCESS The board set was successfully reset. 

MICA_ERROR An error occurred while resetting the 

board(s). 
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MICA__INVALID_NUMBER board_to_reset was set to an invalid 

number. 

5 The MICA__Select function call is used to obtain channel status information such 

as the connection state of a particular chaimel. A format for the call is as follows: 
MICA_Select ( 
intl6 channelld, 
intl6 statusMask 

10 ) 

The parameter channelld identifies the channel, and statusMask is a data word which 
masks off unwanted information. If the statusMask is set to zero, the space available in 
the transmit buffer is returned in response to the function call. The retumed value is ei- 
15 ther the channel status, the space available in the transmit buffer or MICA_ERROR. If 
the most significant bit of the retumed value is set, the retumed value is MICA_ERROR, 
not the channel status. 

The MICA_Send function call is used to hand a data buffer to a specific channel A for- 
20 mat the MICA_Send call is as follows: 
MICA-Send ( 

intl6 channelld, 
char *dataBuffer, 
intl6 bytes 
25 ) 

The channelld parameter identifies the channel from which data is received; the dataBuf- 
fer parameter identifies the buffer into which the data is placed; and the bytes parameter 
indicates the total number of bytes to be transmitted. It should be noted that data cannot 
be transmitted until a channel has entered the active state. Successfully connecting to a 
30 destination or accepting an incoming call causes the channel to transition to the active 
state. The channers status may be verified by using the MICA Select call The result of 

14 

\\CHEETAH\V0L1\CLIENTS\1 12\025\0035C2\PROSECUT\PATAPP.doc 02/07/02 9:22 AM 



PATENT 
112025-0035C2 



the MICA Send call is the number of bytes actiially transmitted. If an error occurs during 
transmit, MICA_ERR0R(-1) is retumed. 

The MICA_SetOption call is used to send various command and control messages 
to the MICA telephone data processing system 24. A list of the commands that can be 
sent is contained in Tables 2 and 3. Table 2 lists modem mode commands, and Table 3 
lists ISDN mode commands. 




MICA MODEM MODE 



MICA MODEM CALL TONE 



MICA MODEM GUARD TONE 



MICA MODEM FORMAT 



MICA MODEM AUTOD 



MICA MODEM AUTOD TO 



MICA MODEM BREAK MODE 



MICA MODEM BUFF LEN 



MICA MODEM NEGOT TO 



MICA MODEM NEGOT FALL B 



Originate/Answer 



Send 



Use Tone 



Async, LAPM, 
MNP, ARA 



Autodetect 
0-25.5S 

Expedited, Destruc- 
tive 

0-64 

0-25.5S 

ASCII Value 



Set the modem to 
Originate or Answer 
mode 

Determines whether 
the modem should 
send calling tone or 
not. 

Should the modem 
use guard tone for 
V 22A^ 22bis. 

Set the modem^s 
data transmission 
format negotiation 
parameters. 

Automatically de- 
tect the peer's proto- 
col 

Autodetect timeout 
period. 

Sets the break proc- 
essing method for 
the modem. 

Protocol buffer 
length. 

Timeout for Proto- 
col Negotiation. 

The character caus- 
ing negotiation fall- 
back. 
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Valiie(s) 




MICA_MODEM_COMPRESSION 


None, V.42bis, 
MNP5 


Compression 
method used by the 
modem. 


CA_MODEM_MODEM_VXX 


V.34bis, V.32bis, 
V.22bis 


The modem stan- 
dard to use. 


MICA_MODEM_MAX_CONN_RATE 


1-14 


2400 * the number 
specified. 


MICA_MODEM_MIN_CONN_RATE 


1-14 


2400 * the number 




1— S 


qxiaUty threshold. 


JVliL-A_MUL'ilM_ 1 A_l^il V HL, 


U— 1 jQDin 


1 lie IXoIlallllL ICVCl. 


MICA_MODEM_IDLE_TO 


1-255S 


Idle line timeout. 


MICA_MODEM_FRAME_RETX 


0-255S 


Frame retransmis- 
sionlimit. 


MICA_MODEM_NO_DCD_HANGUP 


0-25.5S 


Lost carrier hang-up 
uciay. 


MICA_MODEM_RETRAIN_DISC 


1-255S 


Consecutive re-train 


MlL-A_MUlJJiM_rALfL_r WL/_llMJtlK 


1 O^^o 

l-ZjDS 


u i^isconiiccis. 


MlUA_MUlJilM_KlJlj_KiiOr UJN ot. 


Lit M n 1^ 1 A 


JvemUlC lylagXlUSLlC 

Loopback response. 


MICA_MODEM_COUNTRY_CODE 


0-255 


Country Location. 


MICA_MODEM_MIN_ANSWER_BACK 


0-255ms 


Answer back time. 


MICA_MODEM_CALL_TONE_GAIN 


0-15dbm 


Call Tone Gain. 


MICA_MODEM_V.34_INFO 




Information bits for 
V.34. 



Table 2, Set Channel Option Modem Commands 







Dc^criptioii 


MICA_ISDN^ADD_BONDING 


1-29 


Adds an additional 






Bonding channel. 
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MICA ISDN B CHANNEL 



MICA ISDN CALL TYPE 



MICA ISDN CALLED PARTY 



MICA ISDN CALLING PARTY 



MICA ISDN REDIRECT 



1-29 



Voice, Modem, 
56K, 64K 

Number 



Number 



Number 



Requests a specific 
B channel. 

Describes the call 
type. 

Sets the Called 
Party Number for 
identification of in- 
coming calls and the 
number dialed for 
outgoing calls. 

Sets the Calling 
Party Number for 
identification of in- 
coming calls. 

Redirect the call. 



Tables. Set Channel Option ISDN Commands 



A sample format for the MICA SetOption fimction call is as follows: 



MICA_SetOption ( 
intl6 

imsigned long 
char 

) 



channelld, 

micaCommand, 

*arg 



The board_set parameter identifies the MICA board set to be modified. The micaCom- 
mand parameter is the command being sent, and the arg parameter is the command modi- 
fier. The commands are validated and then routed to the appropriate modem or ISDN 
routine. Possible result codes are as follows: 

MICA_INVALID_COMMAND The command specified was not 

recognized. 
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MICA SUCCESS 



The command completed 
successfully. 



MICA ERROR 



The command failed to complete. 



As previously indicated, the host API 18 described above interfaces with 
lower-level APIs 20 and 22 depending upon the call type. Where a call is a modem type 
call, the host API 18 interfaces with the modem API 20. The modem API 20 provides 
low-level function calls to modem processing such as that described in the co-pending 
patent application 08/686,990, incorporated herein. The modem API library of fimction 
calls provides an interface between the host API 18 and board-specific function calls. 
Table 4 includes a list of these modem API functions. 




Call Management 



MICA_MODEM_Close ( ) 
MICA MODEM Intitiate 



MICA_MODEM. 

MICA_MODEM 
Msg() 

MICA_MODEM 
Msg() 

MICA^MODEM 

MICA_MODEM 
0 

MICA MODEM 



LinkCtrl ( ) 
ProcessCtrl 

ProcessData 

Reset ( ) 
_SendCtrlMsg 

SetOptionO 



Terminate a call. 



Either originate or answer a 
call. Determined by the mo- 
dem configuration. 

Force speed shift in modem. 

Process a control message in- 
terrupt from the modem board. 

Process a data message inter- 
rupt from the modem board. 

Software reset of the modem. 

Send a control message to the 
modem. 

Set Modem Options. 



Data Flow 



MICA_MODEM_ 
MICA MODEM 



Recv ( ) 
SEND ( ) 



Receive data from the modem. 
Send data to the modem. 



Initialization 



MICA__MODEM_Configure ( ) 



MICA_MODEM_Init ( ) 



Used to configure a modem for 
a call. 

Initialize the System informa- 
tion. 
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Can Ty pe 








MICA_^MODEM_^Load ( ) 


Load the Modem Board. 


Status 


MICA_^MODEM GetOption ( ) 


Used to solicit the link state 
info. 



Table 4. Modem API Function Call Sunamary 



A detailed description of each of the modem API function calls follows. 
The MICA_MODEM_Close function call is used to terminate a telephone call A 
format for the call is as follows: 

MICA_MODEM_Close ( 

channel_str 

) 

The channelPtr parameter is used to identify the channel that is to be closed. Possible 
result codes are as follows: 

MICA Chan lnvalid The chaimel was not valid. 

MICA_SUCCESS The channel will be closed. 

The MICA MODEM Configure function call is used to configure a modem. A 
format for the function is as follows: 

MICA_MODEM_Configure( 
intl6 channelld, 
intl6 dial, 
) 

The channelld parameter identifies the modem to be modified and the dial parameter in- 
dicates whether the modem should dial a telephone number. The result code that can be 
returned following the function are as follows: 

MICA_SUCCESS The command was sent to the modem. 

MICA_ERROR An error occurred. 

The MICA_MODEM_GetOption function is used to retrieve the status of a mo- 
dem. A format for the function call is as follows: 
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MICA_MODEM_GetOption ( 
channelld_str * chaimelldPtr, 

intl6 command, 
char *arg 
) 

The chamielldPtr parameter identifies the modem to be modified; the command parame- 
ter identifies what is to configured and the arg parameter is a pointer to the buffer for the 
retumed data. Possible result codes are as follows: 

MICA_MODEM_SUCCESS The command was sent to the modem. 

MICA_MODEM_ERROR The parameter was invalid. 

The MICA_MODEM_Imt function call is used to initialize the modem board. A 
format for the call is as follows: 

MICA_^MODEM Jnit ( 

modem str *modemBoard 

) 

The parmneter modemBoard is a pointer to the modem board structure. Possible result 
codes are as follows: 

MICA_SUCCESS The command was sent to the mo- 

dem. 



MIC A_MODEM_P ARAM_INVALID The parameter was invalid. 
MODEM CHAN INVALID The channel was invalid. 

It should be noted that this function should be called prior to calling 
MICA_MODEM_Load. 

The MICA_MODEM Jnitiate function call is used to call the modem to originate 
or answer a call on a data channel. A format for the function is as follows: 
MICA_MODEM Jnitiate ( 
channelld_str *chaimelIdPtr 

) 

The channelldPtr parameter identifies the channel of the telephone call. It should be 
noted that the ISDN processor 44 in the telephone data system 24 must have accepted an 
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inbound call or originated an outbound call prior to calling 5 this function. Possible re- 
sult codes include: 

MICA_MODEM_SUCCESS The command was sent to the mo- 

dem. 



MICA_MODEM_PARAM_INVALID The parameter was invalid. 
MODEM_CHAN_INVALID The channel was invaUd. 

The MICA_MODEM_Load function call is used to load the modem board. A 
format for the function call is as follows: 
MCA MODEM Load ( 
modemstr *modemBoard 

) 

The parameter modemBoard is a pointer to the modem board structure. Possible result 
codes are as follows: 

MICA_SUCCESS The board was loaded. 

MICA_ERROR The parameter was invalid. 

The MICA_MODEM__Recv function call is used to receive data from a specific 
modem. A format for the function call is as follows: 
MICA_MODEM_Recv ( 
channel_str *channelPtr, 
char *dataBuffer, 
intl6 buffer size 

) 

The channelPtr parameter identifies the channel from which the data is received; 
the dataBufifer parameter identifies the buffer into which the data is placed; and the buffer 
size parameter indicates the maximum number of bytes that can be placed in the buffer. 
The result code value returned by the function is the number of bytes actually received. 

The MICA_MODEM__Reset function call is used to perform a software reset of a 
modem board. A format for the function call is as follows: 
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MICA_MODEM_Reset ( 
intl6 board 

) 

The board parameter identifies the board that is to be reset. Possible result codes are as 
follows: 

MICA^SUCCESS The board was reset. 

MICA__ERROR The board number was invalid or the 

board failed to reset. 

The MICA_MODEM_Send function call is used to send data to a specific mo- 
dem. A format for the function call is as follows: 
MICA_MODEM_,Send ( 
chaimel_str *channelPtr, 
char *dataBuffer, 
intl6 bytes 
) 

The channelPtr parameter indicates the channel that the modem is assigned to or associ- 
ated with. The dataBuffer parameter identifies the buffer in which the data is located; 
and the bytes parameter indicates the number of bytes to be sent. It should be noted that 
data cannot be transmitted until the modem has entered the active state. The function call 
MICA_MODEM_Initiate will cause the modem to transition to the active state. The mo- 
dem's status may be verified by using the MICA_Select function call. The result value of 
the MICA_MODEM_Send call is the number of bytes actually transmitted or 
MICA_ERROR if an error occurred during the send process. 

The MICA_MODEM_SetOption function call is used to configure a modem. A 
format for the call is as follows: 
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MICA_MODEM_SetOption ( 
channelld_str *chaimelIdPtr, 
intl6 command, 
char *arg 
) 

The channelldPtr parameter is the channel identifier for the modem to be modified. The 
command parameter is the configuration command, and the arg parameter is a pointer to 
the command parameter, if any. Possible result codes returned by the function call as 
follows: 

MICA_MODEM__SUCCESS The command was sent to the modem. 

MICA_MODEM_PARAM_INVALID The parameter was mvalid. 

MICA_MODEM CHAN_INVALID The channel was invalid. 

The ISDN API 22 provides the interface between the host API 18 and ISDN proc- 
essing 28. The function of the ISDN API 22 is to provide low-level function calls to the 
ISDN processor 44. Like the modem API 20, the ISDN API 22 also includes a number 
of function calls made by the host API 18. The host API 18 uses the ISDN API 22 to 
control and manipulate the ISDN processor 44. The ISDN API 22 provides a layer of 
abstraction between the host API 18 and lower-level ISDN-board specific calls. Table 5 
contains a list of the lower-level ISDN function calls. 





Fiiiictioii -'^^Bil^i^ 




Initialization 


MICA_ISDN_Init() 


Initialize the ISDN board. 




MICAJSDNJnitiate ( ) 


Open a data channel. 




MICA_ISDN_Load ( ) 


Load the board's software. 




MICA_ISDN_SetPath ( ) 


Route a call onto the MVIP line 
orthePRIline. 




MICA_ISDN_Start ( ) 


Starts the board. 




MICA_ISDN_Status 0 


Retrieves ISDN board status. 


Call Management 


MICA_ISDN_Close() 


Close a data channel. 
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MICA_ISDN_GetOption ( ) 
MICA_ISDN_Reset() 
MICA_ISDN_SetOption ( ) 


Performance. 

Reset the IDSN board. 

Call Control Messages. 


Data Flow 


MICA_ISDN_Recv ( ) 
MICA_ISDN_Send ( ) 


Receive ISDN Data. 
Send ISDN Data. 



Table 5: ISDN API Function Call Summary 

A detailed description of each ISDN API function call follows. 
The MICA_ISDN_Init function call is used to initialize the ISDN board, A for- 
mat for the function call is as follows: 

MICA_ISDN_Init( 

isdn_str *isdnStr; 

) 

The isdnStr parameter points to the structure containing the board initialization informa- 
tion. The possible result codes retumed by the function are as follows: 

MICA_ISDN_Success The board was initialized. 

MICA_ISDN_Error An error occxirred. 

The MICA_ISDN_Initiate function call is used to cause the ISDN board to origi- 
nate or answer a call on a data channel. A format for the function call is as follows: 
MICA_ISDN_Imtiate( 
channelld_str * channelldPtr 

) 

The channelldPtr parameter is a pointer to the channel identification structure to identify 
the channel on which the call is to be originated or answered. The possible result codes 
that can be retumed in response to the function are as follows: 

MICAJSDN^SUCCESS The command was sent to the ISDN 

board. 

MICA_ISDN_PARAM_INVALID The parameter was invalid. 



24 

\\CHEETAH\V0L1\CLIENTS\1 12\025\0035C2\PROSECUT\PATAPP.doc 02/07/02 9.22 AM 



PATENT 
112025-0035C2 

MODEM_CHAN_INVALID The channel was invaUd. 

The MICAJSDN_Recv function is used to receive data from a specific ISDN 
chaimeh A format for the function call is as follows: 

MICAJSDN_Recv( 

channel_str *channelPtr, 

char *dataBuffer, 

intl6 bufferSize 

) 

The channelPtr parameter identifies the channel to which the ISDN channel is assigned. 
The dataBuffer parameter identifies the buffer in which the data is located, and the buf- 
ferSize parameter indicates the maximum number of bytes that the buffer can hold. The 
result value of the function indicates the number of bytes actually received, or 
MICA_ERROR can be returned if an error occurred during reception. 

The MICA_ISDN_Reset function is used to reset the ISDN board to a known 
state. A format for the function call is as follows: 

MICA_ISDN_Reset ( 

isdn_str *isdnStr 

) 

The ISDNStr parameter points to the structure containing the ISDN board information. 
The possible result codes are as follows: 

MICA ISDN Success The board was reset, 

MICA ISDN_Error An error occurred. 

The MICA ISDN_SetOption function call is used to send call control messages to 
the ISDN board. A format for the function call is as follows: 
MICA ISDN_SetOption ( 
channel_str *channelPtr, 
intl6 command, 
char *arg 

) 
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The channelPtr parameter identifies the channel carrying the telephone call The com- 
mand parameter is the command sent to the ISDN board, and the arg parameter points to 
a message structure or parameters used in the function, if any. The possible result codes 
are as follows: 

MICA_ISDN_Success The command was sent to the modem. 

MICA JSDN Command lnvalid The parameter was invalid. 
MODEM_Chan_Invalid The channel was invalid. 

The MICAJSDN^SetPath function is used to route data onto the MVIP bus or 
onto the PRI line. A format for the function call is as follows: 

MICA_ISDN_SetPath ( 

channel_str *channelPtr, 

isdn_str *isdnStr 

) 

The channelPtr parameter points to the channel whose data is being routed. The isdnStr 
parameter points to the structure containing the board initialization information. Possible 
result codes are as follows: 

MICA_ISDN_Success The route was established. 

MICA_ISDN_Error An error occurred. 

The MICA ISDN_Send function call is used to send data to a specific ISDN 
channel. A format for the function call is as follows: 
MICA ISDN_Send ( 
channel_str *channelPtr, 
char *dataBuffer, 
intl6 bytes 
) 

The channelPtr parameter indicates the channel to which the ISDN channel is assigned. 
The dataBuffer parameter indicates the buffer in which the data is located, and the bytes 
parameter indicates the total number of bytes to be transmitted. It should be noted that 
data caimot be transmitted until the ISDN channel has entered the active state. The 
MICA_ISDN CHANNEL^Initiate function call causes the ISDN channel to transition to 
the active state. The ISDN channel's status may be verified by using the MICAJSDN 
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CHANNEL Status function call. The result returned in response to the function call is 
the number bytes actually transmitted. 

The MICA_ISDN_Status function call is used to retrieve status from an ISDN 
board. A format for the function call is as follows: 

MICA_ISDN_Status ( 

channel_str *chaimelPtr 

intl6 command 

message_str *messagePtr 

) 

The channelPtr parameter is used to identify the channel whose status is being exmiined. 
The command parameter is the status command, and the messagePtr parameter is a 
pointer to a message structure containing the call parameters. Possible result codes are as 

follows: 

MICA ISDN Success The command was sent to the modem. 

MICA_ISDN_Command_Invalid The parameter was invaUd. 

MODEM_Chan_Invalid The channel was invalid. 

The MICA_ISDN_Close function call is used to close a data channel. A format 
for the function call is as follows: 

MICA_ISDN_^Close ( 

chmmel_str *channelPtr 

) 

The channelPtr parameter is used to identify the chaimel that is to be closed. It should be 
noted that prior to calling this function, the application should issue a 
ISDN_Disable_Data_Channel control message. The possible result codes that can be 
returned in response to the MICA__ISDN_Close function are as follows: 

MICA ISDN_Closed The channel was closed successfully. 

MICA ISDN Chan lnvalid The channel parameter was invalid. 

While this invention has been particularly shown and described with references to 
preferred embodiments thereof, it will be understood by those skilled in the art that vari- 
ous changes in form and details may be made therein without departing from the spirit 
and scope of the invention as defined by Ihe appended claims. 
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